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1 Section 1 

2 1 .0 What is MOTOTRBO™? 

3 

4 MOTOTRBO™ is Motorola’s next generation of Professional Radio that is capable of 

5 analog and digital two-way communications. In addition to the standard features 

6 available with Motorola’s other analog-based products, MOTOTRBO™ brings digital 

7 enhancement to the voice quality as well as an expanded feature set to this product tier. 

8 

9 While operating in digital mode, MOTOTRBO™ uses a two-slot Time Division Multiple 

10 Access (TDMA) air interface to transmit and receive digitized voice and air protocol 

11 control messages simultaneously. This leads to a higher quality of service (QoS) and a 

12 richer user experience with the product. 

13 

14 With the digital mode operation of the MOTOTRBO™ system, customers can expect 

15 end-to-end operation of advanced features and integrated applications such as text 

16 messaging, Location-Based Services (LBS), and telemetry as well as customized 

17 capabilities provided through an internal option board. 
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Figure 1 - MOTOTRBO™ System Example 
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Section 2 

2.0 Extending the MOTOTRBO™ Product 

Aside from the functionality embedded in the radio, the MOTOTRBO™ subscriber’s 
capabilities can be extended through defined application programming interfaces for 3rd 
party developer use. The MOTOTRBO™ Application Development Kits (ADKs) offer an 
opportunity to customize a solution specifically to a customer’s need. 

The MOTOTRBO™ ADKs are comprised of protocol specifications and development 
guidelines that are intended as technical references for the external vendor. These 
ADKs not only include software specifications, but also include electrical and 
mechanical specifications, where applicable. Each interface’s set of technical 
references also detail the specific domain knowledge required to successfully 
implement a 3rd party application for the MOTOTRBO™ product. 

These are the primary ADKs for developer use: 

• MOTOTRBO™ Option Board ADK 

• MOTOTRBO™ XCMP-Based IP Peripheral ADK 

• MOTOTRBO™ Telemetry ADK 

• MOTOTRBO™ Location Data ADK 

• MOTOTRBO™ Text Messaging ADK 

• MOTOTRBO™ Non-IP Capable Peripheral ADK 

Please refer to the individual ADK sections for more information on the interface. Refer 
also to the Appendix: ADK Document Map for more information on document 
components for each ADK. 


2. 1 MOTOTRBO ™Option Board ADK 

The MOTOTRBO™ portable and mobile radios provide a physical and logical 
interface to accommodate an internal option board with an onboard processor 
and embedded logic. This option board interface is the means by which an option 
board, executing its own software application, interoperates with the main board 
firmware to create the custom end-user solution. 

The option board interface of the MOTOTRBO™ product uses the Extended 
Command and Management Protocol (XCMP) to establish a communication 
mechanism between the option board device and the radio. Through this 
protocol, the option board can request notification of ergonomic events such as 
button presses or signals (i.e. carrier detect, PL detect, etc.) in order to take 
further action to process a customized feature. The option board can also 
request the radio to execute certain actions such as display text or route audio in 
order to present a specific ergonomic experience to the user. In addition, the 
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option board can activate or de-activate specific functionality, such as scan, the 
menu system, or an over-the-air data session, to execute the behavior of a new 
feature. 

The option board interface uses a Synchronous Serial Interface (SSI) to transport 
the XCMP control and data messages within XCMP Network Layer (XNL) 
packets to and from the radio and its available services. The SSI is comprised of 
four logic lines: clock, sync, data in, and data out. The option board uses the SSI 
to transport logical and audio data to and from the radio. There are no dedicated 
analog audio lines on the option board interface. Whether the MOTOTRBO™ 
radio is operating in analog or digital mode, all audio is encoded into digital 
format and transported on the SSI bus. 

The SSI bus is a multi-slotted Time Division Multiplexed (TDM) communication 
channel that is shared with other chips and devices contained within or attached 
to the Radio Host. 
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Figure 2 - MOTOTRBO™ Option Board Interface Architecture 


Through the MOTOTRBO™ Option Board interface, custom applications can be 
created to achieve a desired user operation while the MOTOTRBO™ radio is 
operating in either analog or digital mode. The extended functionality provided by 
an option board can be a basic ergonomic feature, such as a “Man-Down” lone 
worker application, or an advanced signal processing feature, such as a custom 
signaling system format. 


The MOTOTRBO™ Option Board interface also has the extended capability to 
communicate with other devices within the radio system. This includes Data 
Applications which are integrated into the Radio Network through a PC 
environment. These Data Applications communicate using User Datagram 
Protocol over Internet Protocol (UDP/IP) sent over the Common Air Interface 
(CAI) of the MOTOTRBO™ Radio. Interoperation with Data Applications is only 
available while MOTOTRBO™ is operating in digital mode. 
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For more information about the MOTOTRBO™ Option Board interface, please 
see the following references: 

• MOTOTRBO™ Option Board ADK Guide 

• MOTOTRBO™ Option Board PROIS Cross-reference 

• MOTOTRBO™ XCMP / XNL Development Guide 

• MOTOTRBO™ XCMP / XNL Development Specification 

For more information about the other interfaces, please refer to the appropriate 
sections contained within this overview. 
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2.2 MOTOTRBO ™XCMP-Based IP Capable Peripheral ADK 

To expand the capability of the MOTOTRBO™ portable and mobile radios, an 
accessory connector is available as a means to provide external physical and 
logical interface. This interface allows the radio to function as a USB device 
attached to an IP capable peripheral. 

The MOTOTRBO™ radio is able to send/receive XCMP/XNL message from an 
external IP capable device via a unique TCP port. The radio attached to the 
external IP capable device executes the XCMP commands from the external 
application and reports the status change. 

Although it operates as a USB device when an external IP capable device 
connects through the radio accessory connector, the MOTOTRBO™ subscriber 
is still considered a master device within the XCMP/XNL architecture. 

When communicating with the radio’s XCMP/XNL interface, the external IP 
capable device becomes an XCMP device. Therefore it can even directly 
communicate with other XCMP devices connected to the radio, for example, the 
Option Board through XCMP/XNL message. 

As an example, Figure 3 illustrates the interface architecture for the 
MOTOTRBO™ IP capable peripheral with an XCMP-based application. 

For more information about the XCMP IP capable peripheral and also its 
operation with other applications offered by the MOTOTRBO™ radio, please see 
the following references: 

• MOTOTRBO™ XCMP Development Guide 

• MOTOTRBO™ XCMP Developer Specification 

• MOTOTRBO™ ADK Data Services Overview 

• MOTOTRBO™ Third Party Peripheral Cable ADK 


Version 01 .02 


8 




MOTOROLA 


MOTOTRBO™ 
Application Development Kit 
Overview 


139 

140 

141 


142 

143 


For more information about the other interfaces, please refer to the appropriate 
sections contained within this overview. 



Figure 3: MOTOTRBO™ IP Capable Peripheral Application Interface Architecture 
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2.3 MOTOTRBO™ Non- IP Capable Peripheral ADK 

The Non-IP Capable Peripheral is a self-powered device that attaches to the 
portable or mobile radio through its accessory connector. It does not use an IP 
stack to communicate with the radio. The peripheral acts as the USB-Host and 
uses XCMP commands to communicate with the MOTOTRBO™ radio. The 
MOTOTRBO™ radio acts as the USB device in the USB connection. 

Below are some examples of possible non-IP Peripheral applications that could 
be developed by third parties: 

• Bar code reader - e.g. inventory management to send bar code info 

• RFID reader - e.g. to send customer specific data 

• Printer - mobile printer connected to a radio 

• VoIP Gateway -e.g. used as telephone interconnect solution 

• Voice Recorder - e.g. to record and store of voice calls and caller 
information 

Universal Serial Bus (USB, version 1.1) is used for the physical layer 
communication. 
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The CDC/ACM class driver is used as the USB device stack to communicate with 
the Non-IP Capable Peripheral USB system driver. 

XCMP/XNL is used as the application communication protocol between the Non- 
IP Capable Peripheral and the MOTOTRBO™ radio. The Non-IP Capable 
Peripheral is considered a non-master device within the XCMP/XNL architecture. 
The XCMP/XNL protocol provides a set of commands for an external device to 
control and manage the MOTOTRBO™ radios. 

The USB and XNL connections are independent of the analog/digital RF modes 
of operation. The Non-IP Capable peripheral does not need to re-establish the 
USB or XNL connections after mode change. 

As an example, Figure 4 illustrates the interface architecture for the 
MOTOTRBO™ Non-IP capable peripheral. 
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Figure 4: MOTOTRBO™ Non-IP Capable Peripheral Application Interface Architecture 


For more information about the Non-IP capable peripheral and also its operation 
with other applications offered by the MOTOTRBO™ radio, please see the 
following references: 

• MOTOTRBO™ XCMP Development Guide 

• MOTOTRBO™ XCMP Developer Specification 

• MOTOTRBO™ Third Party Peripheral Cable ADK 

• MOTOTRBO™ ADK Data Services Overview 
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191 For more information about the other interfaces, please refer to the appropriate 

192 sections contained within this overview. 

193 

194 2.4 MOTOTRBO™Telemetry ADK 

195 The MOTOTRBO™ product can be customized for telemetry operation by 

196 developing a PC-based application using the MOTOTRBO™ Telemetry interface. 

197 A Telemetry Services PC application interoperates with a MOTOTRBO™ radio 

198 via direct USB connection and can monitor or control the general purpose inputs 

199 and outputs (GPIOs) of a radio. Telemetry operation is available while the 

200 MOTOTRBO™ product is operating in digital mode only. 

201 

202 Telemetry operation is available on 3 GPIOs for the MOTOTRBO™ portable and 

203 on 5 GPIOs for the MOTOTRBO™ mobile. The status of telemetry events can be 

204 queried for inputs or outputs. The state transition of telemetry inputs can also be 

205 announced and shown on a display-capable MOTOTRBO™ radio. 

206 

207 Routing of telemetry information in the radio network is accomplished using 

208 UDP/IP. The destination of the telemetry data can be either to a Telemetry 

209 Services PC application or to another device such as an option board. The 

210 Telemetry interface can also broadcast telemetry status over-the-air to specific 

211 MOTOTRBO™ subscribers within the radio network. 

212 
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213 

214 Figure 5 - MOTOTRBO™ Telemetry Interface Architecture 

215 

216 The Telemetry interface enables remote detection or activation of events through 

217 the MOTOTRBO™ system. An example of a telemetry-based solution is an 

218 irrigation system that is automatically activated based on average moisture level. 

219 

220 For more information about the MOTOTRBO™ Telemetry interface, please see 

221 the following references: 

222 

223 • MOTOTRBO™ Telemetry ADK Guide 

224 • MOTOTRBO™ Telemetry Protocol Specification 

225 • MOTOTRBO™ Data Services Overview 
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226 • MOTOTRBO™ Third Party Peripheral Cable ADK 

227 

228 For more information about the other interfaces, please refer to the appropriate 

229 sections contained within this overview. 

230 

231 2.5 MOTOTRBO™Location Data ADK 

232 The MOTOTRBO™ product features optional embedded GPS capability for 

233 Location-Based Services (LBS) with the portable and mobile radio. The location 

234 function provides latitude, longitude, altitude, velocity, and heading data for the 

235 radio. A LBS PC application can also interoperate with the MOTOTRBO™ 

236 product to record a timestamp of reported location data for any specified radio. 

237 The Location Data interface is available while the MOTOTRBO™ product is 

238 operating in digital mode only. 

239 

240 Location status can be configured for periodic or on-request reporting during 

241 normal operation. During emergency operation, the MOTOTRBO™ radio can be 

242 configured for more frequent reporting of location data. 

243 



244 

245 Figure 6 - MOTOTRBO™ Location Data Interface Architecture 
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Messages for requests and responses for location data are handled through the 
Location Request and Response Protocol (LRRP). LRRP is a location data 
reporting protocol that is optimized for use within the MOTOTRBO™ Radio 
Network. LRRP control and data messages are sent via the Radio Network within 
UDP/IP packets that are transported over the Common Air Interface (CAI). The 
LRRP messages are processed directly by the embedded GPS components 
inside the MOTOTRBO™ radio as well as within the LBS PC application. The 
Location Data interface can also interoperate with the MOTOTRBO™ Option 
Board interface to route location data directly to a custom option board device. 

The Location Data interface facilitates asset tracking via location-based services. 
For example, a LBS application can provide an Automated Vehicle Location 
(AVL) capability to track the position of delivery trucks in the coverage area of the 
MOTOTRBO™ system. 

For more information about the MOTOTRBO™ Location Data interface, please 
see the following references: 

• MOTOTRBO™ Location Data ADK Guide 

• MOTOTRBO™ Location Request and Response Protocol (LRRP) 
Specification 

• Motorola Binary XML Encoding Specification 

• MOTOTRBO™ Data Services Overview 

For more information about the other interfaces, please refer to the appropriate 
sections contained within this overview. 


273 2.6 MOTOTRBO™Text Messaging ADK 

274 The MOTOTRBO™ product includes embedded text messaging capability for 

275 one-to-one or one-to-many device destinations. This capability can be extended 

276 to interoperate with a PC-based application to provide enhanced Text Messaging 

277 Services (TMS) using the Text Messaging interface of the MOTOTRBO™ radio. 

278 The TMS feature is available while the MOTOTRBO™ product is operating in 

279 digital mode only. 

280 

281 A text message containing up to 140 characters can be sent between a 

282 subscriber, talkgroup, subscriber with an attached PC (via USB), dispatcher 

283 client, or external network (i.e. the Internet). These messages can be pre-canned 

284 or composed along with a received message inbox for later viewing. 

285 
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286 

287 Figure 7 - MOTOTRBO™ Text Messaging Services Interface Architecture 

288 Text messages are routed within the Radio Network as UDP/IP packets 

289 transported over the MOTOTRBO™ Common Air Interface (CAI). The 

290 destination of text messages is determined by the target IP address and port 

291 number. This enables the routing of text messages to two logically different 

292 devices that are physically connected together (e.g. PC attached to 

293 MOTOTRBO™ radio via USB). In addition, the Text Message interface 

294 interoperates with the MOTOTRBO™ Option Board interface to route text 

295 messages directly to the option board for processing. 

296 

297 The Text Messaging Services interface provides alternate methods for sending 

298 and receiving text messages within the MOTOTRBO™ system. A model 

299 implementation of this interface would be a PC-based dispatch messaging 

300 center. The messaging center contains a user interface for typing text messages 

301 to be sent to an individual radio or a group of radios as well as an output screen 

302 for displaying received messages. 

303 

304 

305 

306 


Version 01 .02 


15 








MOTOROLA 


MOTOTRBO™ 
Application Development Kit 
Overview 


307 For more information about the MOTOTRBO™ Text Messaging Services 

308 Interface, please see the following references: 

309 

310 • MOTOTRBO™ Text Messaging ADK Guide 

311 • MOTOTRBO™ Text Messaging Protocol Specification 

312 • MOTOTRBO™ Data Services Overview 

313 

314 For more information about the other interfaces, please refer to the appropriate 

315 sections contained within this overview. 

316 


317 2.7 MOTOTRBO™Automatic Registration Service (ARS) ADK 

318 The MOTOTRBO™ subscriber has a number of data applications, such as Text 

319 Message, Telemetry and Location, which require the sending of data messages 

320 asynchronously to a Subscriber Unit (SU). The ARS provides a common 

321 registration service that accepts, stores and distributes subscriber presence 

322 information to interested data applications. The ARS can be used by all data 

323 applications and helps to reduce the complexity of handling message 

324 transmissions, as well as promotes the efficient use of air interface bandwidth. 

325 

326 The ARS consists of two components, which are the Registration Application in 

327 MOTOTRBO™ radio and the ARS Server in customer network. The ARS server 

328 is running on a device that is IP capable and is connected to what is called an 

329 ARS radio, via USB connection. The ARS Radio is responsible for routing the IP 

330 messages sent to and from the ARS Server. The transport layer between the 

331 MOTOTRBO™ radio and the ARS Server is UDP/IP. 

332 

333 The Figure 8 shows an example of the architecture diagram for a simple ARS 

334 configuration. Note, in this diagram, a MOTOTRBO™ radio acts as an ARS 

335 Radio. 


1 . Subscription 

2. Registration 



337 Figure 8: Example Architecture Diagram of ARS 

338 


Version 01 .02 


16 






MOTOROLA 


MOTOTRBO™ 
Application Development Kit 
Overview 


339 For more information on the application of the ARS interface and its protocol, 

340 please see the following references: 

341 

342 • MOTOTRBO™ Automatic Registration Service (ARS) ADK Guide 

343 • MOTOTRBO™ Text Messaging ADK Guide 

344 • MOTOTRBO™ Location Data ADK Guide 

345 • MOTOTRBO™ Telemetry ADK Guide 

346 • MOTOTRBO™ Data Services Overview 

347 

348 For more information about the other interfaces, please refer to the appropriate 

349 sections contained within this overview. 

350 
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2.8 Presence Notifier 

The Presence Notifier is used to notify a PC-based backend application, such as 
for telemetry, LBS, or text messaging, that a MOTOTRBO™ radio has powered 
on or off and has registered or de-registered with the system. This application 
allows for efficient bandwidth utilization of the Radio Network - messaging only 
occurs between the backend application and those MOTOTRBO™ subscribers 
that are available and that the application is interested in. The Presence Notifier 
component is for use in digital mode only. 


IP Data Pipe 



Figure 9 - Presence Services Architecture 

The MOTOTRBO™ radio contains an Automatic Registration Service (ARS) that 
sends a registration message to the Presence Notifier within the Radio Network. 
When the MOTOTRBO™ radio is powered down, a de-registration message is 
sent. The registration and de-registration messages are sent as UDP/IP packets 
that are transported over the CAI. The Presence Notifier ultimately receives the 
UDP/IP packets and processes them for the registration state of each 
MOTOTRBO™ radio. 
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371 The Presence Notifier tracks the state of each MOTOTRBO™ radio on the Radio 

372 Network and reports each radio’s state to each Backend Application. Each 

373 backend application must subscribe with the Presence Notifier in order to receive 

374 notifications of each MOTOTRBO™ radio of interest. Information between each 

375 Backend Application and the Presence Notifier is exchanged as UDP/IP packets. 

376 

377 For more information about the Presence Notifier, please see the following 

378 references: 

379 

380 • Presence Notifier Application User’s Guide 

381 • Presence Notifier-to-Watcher Interface Specification 

382 • MOTOTRBO™ Data Services Overview 

383 

384 For more information about the other interfaces, please refer to the appropriate 

385 sections contained within this overview. 

386 

387 2.9 Data Services 

388 Aside from the data application capability of the MOTOTRBO™ product for 

389 telemetry, location, and text messaging, the MOTOTRBO™ radios can also be 

390 used as a generic UDP/IP “pipe” for the transport of data between multiple IP- 

391 capable devices. These devices, such as laptop or desktop PCs, must be 

392 attached to subscriber units operating within the Radio Network. The Data 

393 Services capability is available while the MOTOTRBO™ product is operating in 

394 digital mode only. 

395 
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Figure 10 - Data Services Architecture 

The attached PCs are mapped to an IP space that is separate from the 
MOTOTRBO™ radio IP address range. Therefore, data intended to the attached 
IP-capable device or the MOTOTRBO™ radio can be routed to the appropriate 
endpoint. 

For more information about the Data Services capability, please see the following 
reference: 

• MOTOTRBO™ Data Services Overview 

For more information about the other interfaces, please refer to the appropriate 
sections contained in this overview. 
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411 Section 3 

412 3.0 Professional Radio Application Developer Program 

413 The Professional Radio Application Developer Program now includes MOTOTRBO™ 

414 and is comprised of three tiers of membership: 

415 

416 • Registered User 

417 • Licensed Developer 

418 • Application Partner / Application Provider 

419 

420 Each tier of membership brings greater accessibility to program information and 

421 development resources. Interested developers must be approved for Licensed 

422 Developer or Application Partner status in order to receive items such as: 

423 

424 • Application Development Kit (ADK) documentation 

425 • Technical support, including developer forums and training 

426 • Program affiliation media, including partner logo and application directory listing 

427 • Motorola channel partner and customer information 

428 

429 Registered Users have access to general information and resources only. 

430 
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Figure 11 - Professional Radio Application Developer Program Membership Process Flow 


The capability assessment is based on technical competency, commercial capability, 
and product portfolio. Characteristics that are considered include: 

• Adequate commercial capability 

• Expertise in two-way radio communications 

• Expertise in hardware / software engineering development 

• Adequate development and test environments 

• Repeatable development and test processes 

• Quality Assurance processes 
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4.0 Service & Support for Application Development 

The MOTOTRBO™ Application Development Kits (ADKs) are only one component of 
the service and support for 3rd party developers. The Professional Radio Application 
Developer Program for MOTOTRBO™ is staffed with full-time engineers whose primary 
responsibility is to support 3rd party application developers world-wide. Application 
developers have direct access to Motorola resources to assist in the development and 
certification of the 3rd party application. 

This service and support includes, but is not limited to, the following items: 

• Technical training on the use and capability of the developer interfaces on the 
MOTOTRBO™ radio 

• Application notes and FAQs on relevant MOTOTRBO™ development topics 

• Technical consultation service during the design and development phases of the 
3rd party product 

• Access to a MOTOTRBO™ system test environment with subscribers and 
infrastructure for 3rd party product verification (where supported by the local 
business region) 

In order to ensure technical leadership and growth, the capabilities of the 
MOTOTRBO™ product and the developer interfaces will be continuously improved and 
enhanced for greater functionality and expansion. As a mechanism to support this 
process, Motorola will: 

• Assist developers to define feature enhancements 

• Document and submit change requests for prioritization 

• Track and oversee defect repair of application interfaces 

Through this process, the MOTOTRBO™ product will be ensured to have: 

• Clear, concise, and accurate developer documentation 

• Full compliance with published specifications and guides for each application 
interface 

• Compatibility audit with older release versions of published specifications 
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478 Section 5 

479 5.0 Further Information and Contact 

480 For further information about MOTOTRBO™ and MOTODEV, please visit the following 

481 websites: 

482 

483 • Motorola MOTOTRBO™: http://www.motorola.com/mototrbo 

484 • MOTODEV developer network - Professional Radio Application Developer 

485 Program: http://developer.motorola.com 

486 

487 As an alternative, please contact your region’s business development manager for 

488 further information on how to develop applications for the MOTOTRBO™ platform. 

489 

490 • Asia Pacific Region (APAC) 

491 o APACAPP@motorola.com 

492 

493 • Europe, Middle East, and Africa (EMEA) 

494 o EMEAAPP@motorola.com 

495 

496 • Latin American Countries Region (LACR): 

497 o LACRADP@motorola.com 

498 

499 • North America (NA) 

500 o NAGADP@motorola.com 
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501 Section 6 

502 6.0 Appendix: ADK Document Map 
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MOTOTRBO™ XCMP / XNL Development Guide 

X 




X 

X 

MOTOTRBO™ XCMP / XNL Development Specification 

X 




X 

X 

MOTOTRBO™ Telemetry ADK Guide 


X 





MOTOTRBO™ Telemetry Protocol Specification 


X 
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